OpenBuildings™ Designer 帮助

OpenBuildings 配置

Bentley 应用程序以共享 PowerPlatform 为基础,用于定义产品随附的配置文件中的系统应用程序层。通常,管理员可以在用户提供的配置文件中进行组织、工作空间、工作集和角色级别的更改。每个 Bentley 应用程序都提供了模板配置文件,您可以根据这些文件开始创建自己的配置文件。

配置变量组织为框架配置变量(以“_USTN_”前缀开头)和操作配置变量(大多数以“MS_”前缀开头)。通常,框架配置变量在配置文件中使用,而操作配置变量用于指示应用程序内的程序流。少数框架配置变量由应用程序安装目录确定。其他框架配置变量缺省为相对于安装目录的位置,但是可以在用户提供的配置文件中更改(其中的部分配置变量需要更改)。

配置文件处理可以看作解释简单程序,其中部分由用户不得修改的系统配置文件提供,部分由可供用户修改的配置文件提供。所有配置文件都是可以通过任何文本编辑器进行检查(如果是用户可修改的配置文件,则还可进行修改)的简单文本文件。

系统配置文件位于 <ApplicationName>/config 安装目录中,而用户可修改的配置文件位于配置安装目录或其他用户指定的目录中。用户可修改的配置文件由系统配置文件适时包括在配置文件处理流中。

第 9 部分将“引导”您完成配置文件的处理,并明确用户可修改配置文件可以指定目录和应用程序行为的接触点。

“-debug”命令行参数是帮助理解配置文件处理的关键。该参数指示 Bentley 应用程序写出一个文本文件以包含每个配置文件处理方式历史记录,并在 Windows 系统配置为处理文本文件的任何编辑器(通常为记事本)中打开该文件。当您关闭记事本时,父级 Bentley 应用程序也会关闭。

在 Bentley 应用程序中,也可以使用新的“SHOW CONFIGURATION”命令查看所有配置变量的当前值。此操作还会打开记事本,其中包含当前配置变量。

配置文件语法

配置文件包含以下类型的语句:
注释: 配置变量通常根据其他配置变量定义。根据其他配置变量定义配置变量的语法如下

配置文件处理

配置文件处理从配置文件 mslocal.cfg 开始。这是一个只有几行的“引导”文件,其中包括 msdir.cfg(即,在安装时生成的另一个小配置文件,用于标识 OpenBuildings Designer 安装目录)和 msconfig.cfg(包含配置文件处理的主“程序流”)。

首次自定义配置时,msconfig.cfg 包括 WorkSpaceSetup.cfg

从包括 WorkSpaceSetup.cfg 中返回时,msconfig.cfg 包括 组织配置文件 (如有)。

下一步是包括用户配置文件。用户配置文件作为 Personal.ucf 存储在首选项目录,并存储单个用户的首选项和状态。在此处需要包括此文件,因为最近使用的工作空间和工作集存储在用户配置文件中。

配置过程的下一步是确定 工作空间配置文件 。每个工作空间都有一个名为 <WorkSpace Name>.cfg 的配置文件,该文件必须位于 _USTN_WORKSPACESROOT 指定的目录中。随附提供的 _USTN_WORKSPACESROOT 已定义为 $(_USTN_CONFIGURATION)WorkSpaces/,但您可以按如上所述在 WorkSpaceSetup.cfg 文件中进行更改。

处理工作空间配置文件之后,msconfig.cfg 将尝试加载(且仅加载)一个工作集配置文件。工作空间中的每个工作集都有一个名为 <WorkSetName>.cfg 的配置文件,该文件必须位于 _USTN_WORKSETSROOT 指定的目录中。缺省情况下,_USTN_WORKSETSROOT 已定义为 $(_USTN_WORKSPACEROOT)WorkSets/,但您可以在工作集配置文件中进行更改。

处理工作集配置文件之后,msconfig.cfg 将检查是否已定义 _USTN_ROLECFG。如果已定义,则会处理在 _USTN_ROLECFG 中定义的角色配置文件

工作集选择期间的配置更改

每次选择不同的工作集时,系统都会执行配置变量操作